<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<title>Promise 对象</title>
	</head>
	<body>
		<p>Promise 是异步编程的一种解决方案，比传统的解决方案（回调函数和事件）更合理和更强大。它由社区最早提出和实现，ES6 将其写进了语言标准，统一了用法，原生提供了Promise对象。</p>
		<p>所谓Promise，简单说就是一个容器，里面保存着某个未来才会结束的事件（通常是一个异步操作）的结果。从语法上说，Promise 是一个对象，从它可以获取异步操作的消息。Promise 提供统一的
			API，各种异步操作都可以用同样的方法进行处理。</p>
		<p>Promise对象有以下两个特点：</p>
		<p>（1）对象的状态不受外界影响。Promise对象代表一个异步操作，有三种状态：pending（进行中）、fulfilled（已成功）和rejected（已失败）。只有异步操作的结果，可以决定当前是哪一种状态，任何其他操作都无法改变这个状态。这也是Promise这个名字的由来，它的英语意思就是“承诺”，表示其他手段无法改变。
		</p>
		<p>（2）一旦状态改变，就不会再变，任何时候都可以得到这个结果。Promise对象的状态改变，只有两种可能：从pending变为fulfilled和从pending变为rejected。只要这两种情况发生，状态就凝固了，不会再变了，会一直保持这个结果，这时就称为
			resolved（已定型）。如果改变已经发生了，你再对Promise对象添加回调函数，也会立即得到这个结果。这与事件（Event）完全不同，事件的特点是，如果你错过了它，再去监听，是得不到结果的。</p>
		<script type="text/javascript">
			// Promise构造函数接受一个函数作为参数，该函数的两个参数分别是resolve和reject。它们是两个函数，由 JavaScript 引擎提供，不用自己部署
			// resolve函数的作用是，将Promise对象的状态从“未完成”变为“成功”（即从 pending 变为 resolved），在异步操作成功时调用，并将异步操作的结果，作为参数传递出去
			// reject函数的作用是，将Promise对象的状态从“未完成”变为“失败”（即从 pending 变为 rejected），在异步操作失败时调用，并将异步操作报出的错误，作为参数传递出去。
			let promise = new Promise(function(resolve, reject) {
				// 1.Promise 新建后就会立即执行
				console.log('Promise');
				resolve();
			});
			// 3.Promise实例对象状态改变后，才会触发then方法绑定的回调函数
			promise.then(function() {
				console.log('resolved');
			});
			// 2.由于Promise对象封装的是异步操作，所以此语句执行
			console.log('Hi!');

			// 错误捕获处理的三种方式
			// 写法一
			const p1 = new Promise((resolve, reject) => {
				throw new Error('test1');
			});
			p1.catch(error => console.log(error));
			// 写法二
			const p2 = new Promise((resolve, reject) => {
				try {
					throw new Error('test2');
				} catch (e) {
					reject(e);
				}
			});
			p2.catch(error => console.log(error));
			// 写法三
			const p3 = new Promise((resolve, reject) => {
				reject(new Error('test3'));
			});
			p3.catch(error => console.log(error));

			// Promise 对象重要的函数：
			
			// Promise.prototype.then()方法是为 Promise 实例添加状态改变时的回调函数，有两个参数。第一个参数是resolved状态的回调函数，第二个参数（可选）是rejected状态的回调函数
			
			// Promise.prototype.catch方法是.then(null, rejection)或.then(undefined, rejection)的别名，用于指定发生错误时的回调函数
			
			// Promise.prototype.finally()方法用于指定不管 Promise 对象最后状态如何，都会执行的操作。该方法是 ES2018 引入标准的
			
			// Promise.all()方法用于将多个 Promise 实例，包装成一个新的 Promise 实例
			// const p = Promise.all([p1, p2, p3]);
			// Promise.all()方法的参数可以不是数组，但必须具有 Iterator 接口，且返回的每个成员都是 Promise 实例
			// p的状态由p1、p2、p3决定，分成两种情况：
			// （1）只有p1、p2、p3的状态都变成fulfilled，p的状态才会变成fulfilled，此时p1、p2、p3的返回值组成一个数组，传递给p的回调函数
			// （2）只要p1、p2、p3之中有一个被rejected，p的状态就变成rejected，此时第一个被reject的实例的返回值，会传递给p的回调函数
			
			// Promise.race()方法同样是将多个 Promise 实例，包装成一个新的 Promise 实例
			// const p = Promise.race([p1, p2, p3]);
			// 但不同的是只要p1、p2、p3之中有一个实例率先改变状态，p的状态就跟着改变。那个率先改变的 Promise 实例的返回值，就传递给p的回调函数
			
			// Promise.allSettled()方法接受一组 Promise 实例作为参数，包装成一个新的 Promise 实例。只有等到所有这些参数实例都返回结果，不管是fulfilled还是rejected，包装实例才会结束。该方法由 ES2020 引入
			
			// Promise.any()方法接受一组 Promise 实例作为参数，包装成一个新的 Promise 实例。只要参数实例有一个变成fulfilled状态，包装实例就会变成fulfilled状态；如果所有参数实例都变成rejected状态，包装实例就会变成rejected状态。该方法目前是一个第三阶段的提案 。
		</script>
	</body>
</html>

